Saltar al contenido principal

Envío de correo electrónico con Node-RED

Este tutorial le muestra cómo configurar notificaciones por correo electrónico automáticas desde su cámara OV80i usando Node-RED. Aprenderá a configurar la integración con Gmail y a crear flujos que envíen alertas de inspección, actualizaciones de estado del sistema y notificaciones de fallos directamente a su correo.

Lo que construiremos: Un sistema de correo electrónico automatizado que envía los resultados de inspección de OV80i, alertas y notificaciones a destinatarios especificados usando Gmail SMTP.

Aplicación en el mundo real: Reciba alertas por correo electrónico instantáneas cuando las inspecciones fallen, envíe informes de calidad diarios a la gerencia o notifique a los equipos de mantenimiento sobre problemas del sistema, todo de forma automática desde su sistema de inspección visual.

Prerrequisitos

  • Cámara OV80i con acceso a Node-RED
  • Cuenta de Gmail para enviar correos electrónicos
  • Comprensión básica de flujos de Node-RED
  • Acceso a la configuración de seguridad de la cuenta de Google

Descripción general del tutorial

Lo que construiremos: Un flujo de Node-RED que envía automáticamente notificaciones por correo electrónico con resultados de inspección y alertas del sistema.

Tiempo estimado: 20-30 minutos (incluye la configuración de Gmail)

Habilidades aprendidas: Configuración de la contraseña de la app de Gmail, configuración SMTP, notificaciones automáticas por correo electrónico

Paso 1: Configurar la contraseña de la App de Gmail

1.1 Habilitar la verificación en dos pasos

  1. Inicie sesión en su cuenta de Google en accounts.google.com
  2. Haga clic en "Security" en el menú de navegación de la izquierda
  3. Busque la sección "Signing in to Google"
  4. Haga clic en "2-Step Verification"
  5. Siga las indicaciones para habilitar la verificación en dos pasos si aún no está habilitada

La verificación en dos pasos es obligatoria antes de poder crear contraseñas de la App.

1.2 Generar contraseña de la App

  1. Regrese a la página de Seguridad después de habilitar la verificación en dos pasos
  2. Haga clic en "App passwords" (bajo "Signing in to Google")
  3. Seleccione "Mail" como tipo de aplicación
  4. Seleccione "Other" como tipo de dispositivo
  5. Ingrese un nombre como "OV80i Node-RED Email"
  6. Haga clic en "Generate"

1.3 Guardar su contraseña de la App

  1. Copie la contraseña de 16 caracteres que muestra Google
  2. Guárdela de forma segura - la necesitará para la configuración de Node-RED
  3. Nota: Esta contraseña solo se muestra una vez. Si la pierde, genere una nueva

Punto de control: Debe tener guardada una contraseña de la App de Gmail de 16 caracteres para uso en Node-RED.

Paso 2: Instalar nodos de correo (si es necesario)

2.1 Verificación de nodos de correo electrónico

  1. Abra Node-RED en su cámara OV80i
  2. Busque en la paleta izquierda un nodo "email" en la sección de salida
  3. Si falta, deberá instalar el paquete de correo

2.2 Instalar el paquete de correo electrónico (si es necesario)

  1. Haga clic en el menú hamburguesa (≡) en Node-RED
  2. Seleccionar "Gestión de paleta"
  3. Haga clic en la pestaña "Install"
  4. Buscar "node-red-node-email"
  5. Haga clic en "Install" junto al paquete

Paso 3: Crear flujo básico de correo

3.1 Añadir nodos requeridos

  1. Navegue al IO Block > Configure I/O para acceder a Node-RED
  2. Arrastre estos nodos desde la paleta a su lienzo:
    • Inject node (para pruebas)
    • Email node (de la sección de salida)
  3. Conecte la salida de Inject a la entrada de Email

3.2 Estructura básica del flujo

Inject → Email

Propósito del flujo: Envío simple de correo para pruebas y notificaciones básicas.

image.png

Paso 4: Configurar el Contenido del Correo

4.1 Configurar Nodo Inject

  1. Doble clic en el nodo Inject para abrir las propiedades
  2. Configurar el payload:
    • Payload type: "string"
    • Payload value: Texto del cuerpo del correo (p. ej., "Inspection alert from OV80i")
  3. Agregar asunto de correo:
    • Haga clic en "+ add" para agregar una propiedad

    • Nombre de la propiedad: "topic"

    • Valor de la propiedad: Su asunto de correo (p. ej., "OV80i Inspection Alert")

      image.png

4.2 Ejemplo de Configuración Básica

Payload (email body):

Inspection completed at Station 1
Status: Alert triggered
Time: Check timestamp for details

Topic (email subject):

OV80i Inspection Alert - Station 1

4.3 Guardar Configuración de Inject

  1. Asigne un nombre al nodo como "Email Trigger"
  2. Haga clic en "Done" para guardar la configuración

Paso 5: Configurar la Configuración SMTP de Correo

5.1 Configurar Nodo de Correo

  1. Doble clic en el nodo de correo para abrir las propiedades
  2. Configurar ajustes básicos:
    • Nombre: "Send Alert Email" (o un nombre descriptivo)
    • To: Dirección de correo del destinatario (p. ej., quality@company.com)

5.2 Configurar Gmail SMTP

  1. Servidor: smtp.gmail.com
  2. Puerto: 465
  3. Marque "Use secure connection"
  4. Tipo de autenticación: Basic
  5. Usuario: Su dirección de Gmail completa (p. ej., alerts@company.com)
  6. Contraseña: La contraseña de aplicación de 16 caracteres de Paso 1

5.3 Configuración de Seguridad

  1. Marque "Check server certificate is valid"
  2. Verifique que todas las configuraciones estén ingresadas correctamente
  3. Haga clic en "Done" para guardar la configuración del nodo de correo

Checkpoint: Su nodo de correo no debe mostrar indicadores de error y debe mostrar la dirección del destinatario.

image.png

Paso 6: Probar su Flujo de Correo

6.1 Implementar y Probar

  1. Haga clic en "Deploy" botón en la esquina superior derecha
  2. Espere el mensaje "Successfully deployed"
  3. Haga clic en el botón del nodo inject (cuadrado gris en el lado izquierdo)

6.2 Verificar la Entrega de Correo

  1. Verifique la dirección de correo del destinatario para el mensaje de prueba
  2. Verifique la carpeta de spam si el correo no aparece en la bandeja de entrada
  3. Busque mensajes de error en el panel de depuración de Node-RED

6.3 Solución de Problemas, si es Necesario

Problemas comunes:

  • Contraseña de aplicación incorrecta: Regenerar la contraseña de aplicación de Gmail
  • Ajustes SMTP: Verifique que el servidor y el puerto sean correctos
  • Cortafuegos: Asegure que el tráfico SMTP saliente esté permitido

Paso 7: Integración con los Resultados de Inspección

7.1 Conectar al Flujo de Inspección

Para enviar correos basados en los resultados de inspección:

  1. Encuentre su flujo principal de inspección (comienza con "All Block Outputs")
  2. Agregue su flujo de correo como una rama del procesamiento de inspección
  3. Conecte después de la lógica de inspección, pero en paralelo a los resultados finales

7.2 Flujo de Integración de Ejemplo

All Block Outputs → [Inspection Logic] → Final Pass/Fail

Format Email → Send Email

image.png

7.3 Contenido dinámico de correo electrónico

Reemplace el nodo de inyección por un nodo de función para contenido dinámico:

// Dynamic email based on inspection results
const result = msg.payload.result ? "PASSED" : "FAILED";
const timestamp = new Date().toLocaleString();
const station = global.get("station_name") || "Unknown Station";

// Set email subject
msg.topic = `Inspection ${result} - ${station}`;

// Set email body
msg.payload = `Inspection Report:
Status: ${result}
Station: ${station}
Time: ${timestamp}
Image: ${msg.payload.image_url || "No image available"}

Please review and take appropriate action.`;

return msg;

Paso 8: Ejemplo de Flujo Completo

8.1 Importar Flujo Preconfigurado

Puede importar este JSON de flujo completo:

[
{
"id": "email_node_1",
"type": "e-mail",
"name": "Send Inspection Alert",
"server": "smtp.gmail.com",
"port": "465",
"secure": true,
"authtype": "BASIC",
"to": "quality@company.com"
},
{
"id": "format_email",
"type": "function",
"name": "Format Email Content",
"func": "const result = msg.payload.result ? 'PASSED' : 'FAILED';\nmsg.topic = `Inspection ${result}`;\nmsg.payload = `Status: ${result}\\nTime: ${new Date()}`;\nreturn msg;"
}
]

8.2 Personalizar según sus necesidades

  1. ** Actualice las direcciones de correo electrónico** para su organización
  2. Modifique el contenido del correo para sus requisitos específicos
  3. Ajuste la temporización y las condiciones de disparo
  4. Pruebe a fondo antes del despliegue en producción

Solución de Problemas

Problemas Comunes

ProblemaSíntomasSolución
Fallo de autenticaciónErrores de "Login failed"Verifique que la contraseña de la aplicación sea correcta y que la verificación en dos pasos esté habilitada
Tiempo de espera de conexiónNo se envía correo, errores de tiempo de esperaVerifique la configuración del firewall, verifique el servidor SMTP y el puerto
Correos en spamCorreos entregados pero en la carpeta de spamAñada al remitente a la lista de seguridad, mejore el contenido del correo
Flujo no se disparaNo hay salida de depuraciónVerifique las conexiones del flujo y las condiciones de disparo

Depure su Flujo de Correo

  1. Agregue nodos de depuración después de cada paso para rastrear datos
  2. Verifique los registros de Node-RED para mensajes de error detallados
  3. Pruebe la configuración SMTP con clientes de correo externos si es necesario
  4. Verifique la conectividad de red desde la cámara hasta los servidores de Gmail

¡Éxito! La Integración de Correo Electrónico está Completa

La cámara OV80i ahora puede:

Enviar notificaciones por correo electrónico automáticas de los resultados de la inspección

Entregar mensajes ricos y formateados con los detalles de la inspección

Soportar múltiples destinatarios y flujos de escalación

Proporcionar informes programados y resúmenes

Manejar mensajes condicionales basados en los resultados de la inspección

Mejores Prácticas

Gestión de Correo

  • Utilice asuntos descriptivos con indicadores de estado claros
  • Mantenga los mensajes concisos pero informativos
  • Incluya marcas de tiempo e identificadores de estación
  • Proporcione información accionable en las notificaciones

Seguridad y Fiabilidad

  • Proteja las contraseñas de la aplicación: guárdelas de forma segura y cámbielas regularmente
  • Utilice cuentas de correo dedicadas para notificaciones del sistema
  • Pruebe la entrega de correo de forma regular para garantizar la fiabilidad
  • Supervise fallos de entrega y tenga métodos de notificación de respaldo

Consideraciones de Rendimiento

  • Limitar la frecuencia de correos electrónicos para evitar la detección de spam
  • Utilice listas de destinatarios adecuadas para los diferentes tipos de alertas
  • Implemente limitación de tasa para sistemas de alto volumen
  • Considere el tamaño del correo al incluir adjuntos grandes

Próximos Pasos

Después de configurar las notificaciones por correo electrónico:

  1. Crear plantillas de correo electrónico para diferentes tipos de alertas
  2. Configurar listas de distribución para diversas partes interesadas
  3. Implementar flujos de escalamiento para incidentes críticos
  4. Crear informes programados para la gerencia
  5. Integrar con otros sistemas de notificación (SMS, Teams, etc.)

🔗 Ver También